<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "https://www.w3.org/TR/html4/loose.dtd">
<html lang="zh-CN"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><meta http-equiv="Content-Language" content="zh-CN"><link href="stylesheet.css" media="all" rel="stylesheet" type="text/css">
<title>SPI_cursor_open</title>
<script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?d286c55b63a3c54a1e43d10d4c203e75"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script>
</head><body class="REFENTRY">
<div>
<table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr><th colspan="5" align="center" valign="bottom">PostgreSQL 8.2.3 中文文档</th></tr>
<tr><td width="10%" align="left" valign="top"><a href="spi-spi-execp.html" accesskey="P">后退</a></td><td width="10%" align="left" valign="top"><a href="spi-spi-execp.html">快退</a></td><td width="60%" align="center" valign="bottom"></td><td width="10%" align="right" valign="top"><a href="spi-spi-cursor-find.html">快进</a></td><td width="10%" align="right" valign="top"><a href="spi-spi-cursor-find.html" accesskey="N">前进</a></td></tr>
</table>
<hr align="LEFT" width="100%"></div>
<h1><a name="SPI-SPI-CURSOR-OPEN"></a>SPI_cursor_open</h1>
<div class="REFNAMEDIV"><a name="AEN42568"></a><h2>函数名</h2>SPI_cursor_open&nbsp;--&nbsp;用 <code class="FUNCTION">SPI_prepare</code> 创建的规划设置一个游标</div>
<a name="AEN42572"></a>
<div class="REFSYNOPSISDIV"><a name="AEN42574"></a><h2>原型</h2>
<pre class="SYNOPSIS">Portal SPI_cursor_open(const char * <tt class="PARAMETER">name</tt>, void * <tt class="PARAMETER">plan</tt>,
                       Datum * <tt class="PARAMETER">values</tt>, const char * <tt class="PARAMETER">nulls</tt>,
                       bool <tt class="PARAMETER">read_only</tt>)</pre>
</div>
<div class="REFSECT1"><a name="AEN42581"></a><h2>描述</h2>
<p><code class="FUNCTION">SPI_cursor_open</code> 设置一个游标(内部叫入口)，这个游标可以执行 <code class="FUNCTION">SPI_prepare</code> 准备的规划。参数和对应的 <code class="FUNCTION">SPI_execute_plan</code> 参数具有相同的含义。</p>
<p>使用游标而不是直接执行规划有两个优点。首先，结果行可以每次检索一小部分，避免那些返回大量数据行的查询造成的内存缺乏。第二，一个入口可以在当前过程之外存货(实际上，它可以活到当前事务的结尾)。给过程的调用者返回一个入口名是一种返回行结果集的方法。</p>
</div>
<div class="REFSECT1"><a name="AEN42588"></a><h2>参数</h2>
<div class="VARIABLELIST">
<dl>
<dt><tt class="LITERAL">const char * <tt class="PARAMETER">name</tt></tt></dt>
<dd><p>入口的名字，或者是用 <tt class="SYMBOL">NULL</tt> 让系统选择一个名字</p></dd>
<dt><tt class="LITERAL">void * <tt class="PARAMETER">plan</tt></tt></dt>
<dd><p>执行规划(<code class="FUNCTION">SPI_prepare</code> 返回)</p></dd>
<dt><tt class="LITERAL">Datum * <tt class="PARAMETER">values</tt></tt></dt>
<dd><p>一个实际参数值的数组。必须和规划的参数个数等长。</p></dd>
<dt><tt class="LITERAL">const char * <tt class="PARAMETER">nulls</tt></tt></dt>
<dd><p>一个描述那些参数是 NULL 的数组。必须和规划的参数个数等长。<tt class="LITERAL">n</tt> 表示一个 NULL(在 <tt class="PARAMETER">values</tt> 里对应的元素将被忽略)；一个空白表示一个非 NULL(在 <tt class="PARAMETER">values</tt> 里的条目是有效的)。</p>
<p>如果 <tt class="PARAMETER">nulls</tt> 是 <tt class="SYMBOL">NULL</tt> 那么 <code class="FUNCTION">SPI_cursor_open</code> 假设没有参数是空。</p></dd>
<dt><tt class="LITERAL">bool <tt class="PARAMETER">read_only</tt></tt></dt>
<dd><p>对于只读的执行为 <tt class="LITERAL">true</tt></p></dd>
</dl>
</div>
</div>
<div class="REFSECT1"><a name="AEN42631"></a><h2>返回值</h2>
<p>指向包含入口游标的指针，或者是错误的时候是 <tt class="SYMBOL">NULL</tt></p>
</div>
<div>
<hr align="LEFT" width="100%">
<table summary="Footer navigation table" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr><td width="33%" align="left" valign="top"><a href="spi-spi-execp.html" accesskey="P">后退</a></td><td width="34%" align="center" valign="top"><a href="index.html" accesskey="H">首页</a></td><td width="33%" align="right" valign="top"><a href="spi-spi-cursor-find.html" accesskey="N">前进</a></td></tr>
<tr><td width="33%" align="left" valign="top">SPI_execp</td><td width="34%" align="center" valign="top"><a href="spi-interface.html" accesskey="U">上一级</a></td><td width="33%" align="right" valign="top">SPI_cursor_find</td></tr>
</table>
</div>
</body></html>